home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / gnome-doc-utils / templates / gnome-app-template.xml next >
Encoding:
Extensible Markup Language  |  2009-09-22  |  29.9 KB  |  862 lines
  1. <?xml version="1.0"?>
  2. <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
  3. "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  4.   <!ENTITY appname          "MY-GNOME-APPLICATION">
  5.   <!ENTITY app "<application>MY-GNOME-APPLICATION</application>">
  6.   <!ENTITY appversion   "2.0">
  7.   <!ENTITY manrevision  "2.0">
  8.   <!ENTITY date "March 2002">
  9.   <!-- Information about the entities
  10.        Use the app and appname entities to specify the name of the application.  
  11.        Use the appversion entity to specify the version of the application.
  12.        Use the manrevision entity to specify the revision number of this manual.
  13.        Use the date entity to specify the release date of this manual.
  14. -->
  15. ]>
  16. <!-- 
  17.   This is a GNOME documentation template, designed by the GNOME
  18.   Documentation Project Team. Please use it for writing GNOME
  19.   documentation, making obvious changes, such as:
  20.   - all the words written in UPPERCASE (with the exception of GNOME) 
  21.     should be replaced. As for "legalnotice", please leave the reference
  22.     unchanged.
  23.   - all id attributes should have 'myapp' replaced
  24.  
  25.   Remember that this is a guide, rather than a perfect model to follow
  26.   slavishly. Make your manual logical and readable: see the GDP Style Guide for
  27.   more on this.
  28. -->
  29. <!--
  30.       (Do not remove this comment block.)
  31.   Maintained by the GNOME Documentation Project
  32.   http://live.gnome.org/DocumentationProject
  33.   Template version: 3.0 beta
  34.   Template last modified 2006-11-21
  35.  
  36. -->
  37. <!-- =============Document Header ============================= -->
  38. <article id="index" lang="en">
  39.   <articleinfo> 
  40.     <title>&app; Manual</title>
  41.     <abstract role="description">
  42.       <para>&app; is ... <!-- insert brief description -->.</para>
  43.     </abstract>         
  44.  
  45.     <copyright> 
  46.       <year>2006</year> 
  47.       <holder>GNOME Documentation Project</holder> 
  48.     </copyright> 
  49.  
  50.     <!-- An address can be added to the publisher information. -->
  51.     <publisher role="maintainer"> 
  52.       <publishername>GNOME Documentation Project</publishername> 
  53.     </publisher> 
  54.  
  55.       <xi:include href="legal.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
  56.     <!-- The file legal.xml contains link to license for the documentation, 
  57.         and other legal stuff such as "NO WARRANTY" statement. 
  58.         Please do not change any of this. -->
  59.  
  60.     <authorgroup> 
  61.       <author> 
  62.             <firstname>Documentation</firstname> 
  63.             <surname>Writer 2</surname> 
  64.             <affiliation> 
  65.                   <orgname>GNOME Documentation Project</orgname> 
  66.                   <!-- The email address of the author is optional and is commented out by default. 
  67.                 <address> <email>doc-writer2@gnome.org</email> </address> 
  68.                 -->
  69.             </affiliation> 
  70.       </author> 
  71.       <author> 
  72.             <firstname>Documentation</firstname> 
  73.             <surname>Writer 1</surname> 
  74.             <affiliation> 
  75.                   <orgname>GNOME Documentation Project</orgname> 
  76.                   <!-- The email address of the author is optional and is commented out by default. 
  77.                 <address> <email>doc-writer2@gnome.org</email> </address> 
  78.                 -->
  79.             </affiliation> 
  80.       </author> 
  81.     </authorgroup>
  82.     
  83.  
  84. <!-- According to GNU FDL, revision history is mandatory if you are -->
  85. <!-- modifying/reusing someone else's document.  If not, you can omit it. -->
  86. <!-- Remember to remove the &manrevision; entity from the revision entries other
  87. -->
  88. <!-- than the current revision. -->
  89. <!-- The revision numbering system for GNOME manuals is as follows: -->
  90. <!-- * the revision number consists of two components -->
  91. <!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
  92. <!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
  93. <!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
  94. <!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
  95. <!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
  96. <!-- to V3.0, and so on. -->  
  97.     <revhistory>
  98.       <revision> 
  99.         <revnumber>MY-GNOME-APPLICATION Manual V&manrevision;</revnumber> 
  100.         <date>&date;</date> 
  101.         <revdescription> 
  102.               <para role="author">Documentation Writer 2
  103.         <!-- The email address of the author is optional and is commented out by default.  
  104.             <email>docwriter2@gnome.org</email> -->
  105.               </para>
  106.               <para role="publisher">GNOME Documentation Project</para>
  107.         </revdescription> 
  108.       </revision> 
  109.       <revision> 
  110.         <revnumber>Full title of previous manual.</revnumber> 
  111.         <date>Release date of previous manual.</date> 
  112.         <revdescription> 
  113.               <para role="author">Documentation Writer 1 
  114.         <!-- The email address of the author is optional and is commented out by default. 
  115.             <email>docwriter1@gnome.org</email> -->
  116.               </para>
  117.               <para role="publisher">GNOME Documentation Project</para>
  118.         </revdescription> 
  119.       </revision> 
  120.     </revhistory> 
  121.  
  122.     <releaseinfo>This manual describes version &appversion; of MY-GNOME-APPLICATION.
  123.     </releaseinfo> 
  124.     <legalnotice> 
  125.       <title>Feedback</title> 
  126.       <para>To report a bug or make a suggestion regarding the &app; application or
  127.       this manual, follow the directions in the 
  128.       <ulink url="ghelp:user-guide?feedback-bugs" type="help">Feedback section of the GNOME User Guide</ulink>. 
  129.       </para>
  130. <!-- Translators may also add here feedback address for translations -->
  131.     </legalnotice> 
  132.   </articleinfo> 
  133.  
  134.   <indexterm zone="index"> 
  135.     <primary>MY-GNOME-APP</primary> 
  136.   </indexterm> 
  137.   <indexterm zone="index"> 
  138.     <primary>mygnomeapp</primary> 
  139.   </indexterm>
  140.  
  141. <!-- ============= Document Body ============================= -->
  142. <!-- ============= Introduction ============================== -->
  143. <!-- Use the Introduction section to give a brief overview of what
  144.      the application is and what it does. -->
  145.   <sect1 id="myapp-introduction"> 
  146.     <title>Introduction</title> 
  147.     <para>Use &app; to view image files. 
  148.     &app; provides the following features:</para> 
  149.     <itemizedlist> 
  150.       <listitem> 
  151.         <para>Support for the following image file formats:</para> 
  152.         <itemizedlist> 
  153.               <listitem> 
  154.             <para>BMP - Windows Bitmap</para> 
  155.               </listitem> 
  156.               <listitem> 
  157.             <para>GIF - Graphics Interchange Format</para> 
  158.               </listitem> 
  159.               <listitem> 
  160.             <para>ICO - Windows Icon</para> 
  161.               </listitem> 
  162.               <listitem> 
  163.             <para>JPEG - Joint Photographic Experts Group</para> 
  164.               </listitem> 
  165.               <listitem> 
  166.             <para>PNG - Portable Network Graphics </para> 
  167.               </listitem> 
  168.               <listitem> 
  169.             <para>PNM - Portable Anymap from the PPM Toolkit</para> 
  170.               </listitem> 
  171.               <listitem> 
  172.             <para>RAS - Sun Raster </para> 
  173.               </listitem> 
  174.               <listitem> 
  175.             <para>TIFF - Tagged Image File Format</para> 
  176.               </listitem> 
  177.               <listitem> 
  178.             <para>XPM - X Pixmap</para> 
  179.               </listitem> 
  180.         </itemizedlist> 
  181.       </listitem> 
  182.       <listitem> 
  183.       <para>A variety of zoom levels and full screen viewing, with low usage
  184.       of memory regardless of the zoom level. </para> 
  185.       </listitem> 
  186.     </itemizedlist> 
  187.     <note>
  188.       <para>This is a note.</para>
  189.     </note>
  190.   </sect1>
  191.  
  192. <!-- =========== Getting Started ============================== -->
  193. <!-- Use the Getting Started section to describe the steps required
  194.      to start the application and to describe the user interface components
  195.      of the application. If there is other information that it is important
  196.      for readers to know before they start using the application, you should
  197.      also include this information here. 
  198.      If the information about how to get started is very short, you can 
  199.      include it in the Introduction and omit this section. -->
  200.  
  201.   <sect1 id="myapp-getting-started"> 
  202.     <title>Getting Started</title> 
  203.  
  204.     <sect2 id="myapp-start">
  205.     <title>Starting &app;</title>
  206.     <para>You can start &app; in the following ways:
  207.     </para> 
  208.     <variablelist>
  209.         <varlistentry>
  210.             <term><guimenu>Applications</guimenu> menu</term>
  211.             <listitem>
  212.             <para>Choose 
  213.             <menuchoice>
  214.             <guisubmenu>Submenu Name </guisubmenu>
  215.             <guimenuitem>My-GNOME-APPLICATION</guimenuitem>
  216.             </menuchoice>. </para>
  217.             </listitem>
  218.         </varlistentry>
  219.         <varlistentry>
  220.             <term>Command line</term>
  221.             <listitem>
  222.             <para>To start &app; from a command line, type the following command, 
  223.             then press <keycap>Return</keycap>:</para>
  224.             <para> 
  225.             <command>myapp</command> 
  226.             <replaceable>filename.jpg</replaceable>
  227.             </para> 
  228.             <para>where 
  229.             <replaceable>filename.jpg</replaceable> is the name of the file you
  230.             want to open.
  231.             </para> 
  232.             <para>&app; opens each file that you specify in a new window.</para> 
  233.             </listitem>
  234.         </varlistentry>
  235.     </variablelist>
  236.     </sect2>
  237.  
  238.     <sect2 id="myapp-when-start">
  239.     <title>When You Start &app;</title>
  240.     <para>When you start &app;, the following window is displayed.</para>
  241.  
  242.     <!-- ==== Figure ==== -->
  243.       <figure id="mainwindow-fig"> 
  244.     <title>&app; Start Up Window</title> 
  245.     <screenshot> 
  246.       <mediaobject> 
  247.         <imageobject><imagedata
  248.         fileref="figures/myapp_start_window.png" format="PNG"/> 
  249.         </imageobject>
  250.         <!-- EPS versions of the figures are not required at the moment. -->
  251.             <!-- 
  252.             <imageobject>
  253.               <imagedata fileref="figures/image.eps" format="EPS"/>
  254.                 </imageobject>
  255.         -->
  256.         <textobject> 
  257.           <phrase>Shows &app; main window. Contains titlebar, menubar, toolbar, display area, and
  258.           scrollbars. Menubar contains File, View, Settings, and Help menus. </phrase> 
  259.         </textobject> 
  260.       </mediaobject> 
  261.     </screenshot> 
  262.       </figure>
  263.     <!-- ==== End of Figure ==== -->
  264.  
  265.     <!-- Include any descriptions of the GUI immediately after the screenshot of the main UI, -->
  266.     <!-- for example, the items on the menubar and on the toolbar. This section is optional. -->
  267.  
  268.     <para>The &app; window contains the following elements:
  269.     </para>
  270.       <variablelist>
  271.     <varlistentry>
  272.     <term>Menubar. </term>
  273.     <listitem>
  274.     <para>The menus on the menubar contain all of the commands you need to work with files in 
  275.     &app;.</para>
  276.     </listitem>
  277.     </varlistentry>
  278.     <varlistentry>
  279.     <term>Toolbar. </term>
  280.     <listitem>
  281.     <para> The toolbar contains a subset of the commands that you can access from the menubar.</para>
  282.     </listitem>
  283.     </varlistentry>
  284.     <varlistentry>
  285.     <term>Statusbar. </term>
  286.     <listitem>
  287.     <para>The statusbar displays information about current &app; 
  288.     activity and contextual information about the menu items. </para>
  289.     </listitem>
  290.     </varlistentry>
  291.     </variablelist>
  292.     </sect2>
  293.   </sect1>
  294. <!-- ================ Usage ================================ -->
  295. <!-- Use this section to describe how to use the application to perform the tasks for which the application is designed.
  296.      If this section runs to more than a few screens in Yelp, consider splitting it into several top-level sections.
  297.   -->
  298.   <sect1 id="myapp-usage"> 
  299.     <title>Usage</title> 
  300.     <para>You can use the &app; application to
  301.       perform the following tasks: 
  302.       <itemizedlist> 
  303.     <listitem> 
  304.       <para> 
  305.         <xref linkend="myapp-open-image"/></para> 
  306.     </listitem> 
  307.     <listitem> 
  308.       <para> 
  309.         <xref linkend="myapp-manipulate-view"/></para> 
  310.     </listitem> 
  311.     <listitem> 
  312.       <para> 
  313.         <xref linkend="myapp-scroll-image"/></para>
  314.     </listitem> 
  315.     <listitem> 
  316.       <para> 
  317.         <xref linkend="myapp-close-image"/></para> 
  318.     </listitem> 
  319.       </itemizedlist> </para>
  320.     <!-- ================ Usage Subsection ================================ -->
  321.     <sect2 id="myapp-open-image"> 
  322.       <title>Opening an Image</title> 
  323.       <para>To open an image, choose 
  324.     <menuchoice> 
  325.       <guimenu>File</guimenu> 
  326.       <guimenuitem>Open Image</guimenuitem> 
  327.     </menuchoice>. The 
  328.     <guilabel>Open Image</guilabel> dialog is displayed. Select the file
  329.     that you want to open, then click 
  330.     <guibutton>OK</guibutton>. To open another image in a new window,
  331.     choose 
  332.     <menuchoice> 
  333.       <guimenu>File</guimenu> 
  334.       <guimenuitem>Create New Window</guimenuitem> 
  335.     </menuchoice>. Choose 
  336.     <menuchoice> 
  337.       <guimenu>File</guimenu> 
  338.       <guimenuitem>Open Image</guimenuitem> 
  339.     </menuchoice> 
  340.     to select the file that you want to open. You can also drag an image
  341.     from another application such as a file manager to the &app;
  342.     window. If the &app; window is empty, the application displays
  343.     the image in the window. If the window is not empty, the
  344.     application starts a new window to display the file. The
  345.     application displays the name of the image file and the size
  346.     of the image in pixels in the titlebar of the window. </para>
  347.       <para>
  348.     If you try to open an image file format that &app; does
  349.     not recognize, the application displays an error
  350.     message.
  351.       </para>
  352.       <caution>
  353.       <para>This is a caution.</para>
  354.       </caution>
  355.     </sect2> 
  356.     <!-- ================ Usage Subsection ================================ -->
  357.      <sect2 id="myapp-manipulate-view"> 
  358.       <title>Manipulating the View of an Image</title> 
  359.       <para>You can use the following methods to resize the view of an image in
  360.     the &app; window:</para> 
  361.       <itemizedlist> 
  362.     <listitem> 
  363.       <para>To enlarge the view of an image, choose 
  364.         <menuchoice> 
  365.           <guimenu>View</guimenu> 
  366.           <guimenuitem>Zoom In</guimenuitem> 
  367.         </menuchoice>.</para> 
  368.     </listitem> 
  369.     <listitem> 
  370.       <para>To shrink the view of an image, choose 
  371.         <menuchoice> 
  372.           <guimenu>View</guimenu> 
  373.           <guimenuitem>Zoom Out</guimenuitem> 
  374.         </menuchoice>.</para> 
  375.     </listitem> 
  376.     <listitem> 
  377.       <para>To view the image at its actual size, choose 
  378.         <menuchoice> 
  379.           <guimenu>View</guimenu> 
  380.           <guimenuitem>Zoom 1:1</guimenuitem> 
  381.         </menuchoice>. </para> 
  382.     </listitem> 
  383.     <listitem> 
  384.       <para>To enlarge or shrink the view of an image so that the image
  385.         fits the &app; window, choose 
  386.         <menuchoice> 
  387.           <guimenu>View</guimenu> 
  388.           <guimenuitem>Fit to Window</guimenuitem> 
  389.         </menuchoice>.</para> 
  390.     </listitem> 
  391.     <listitem> 
  392.       <para>To enlarge or shrink the image to a specific zoom factor,
  393.         choose 
  394.         <menuchoice> 
  395.           <guimenu>View</guimenu> 
  396.           <guimenuitem>Zoom factor</guimenuitem> 
  397.         </menuchoice>, then choose the appropriate zoom factor from the
  398.         drop-down list.</para> 
  399.     </listitem> 
  400.     <listitem> 
  401.       <para>To display the image in full screen mode, choose 
  402.         <menuchoice> 
  403.           <guimenu>View</guimenu> 
  404.           <guimenuitem>Full Screen</guimenuitem> 
  405.         </menuchoice>. Full screen mode displays the image in a window that
  406.         fills the full screen. The window does not contain a
  407.         window frame, titlebar, 
  408.         menubar, or toolbar. To exit from this mode, press the 
  409.         <keycap>Esc</keycap> key or 
  410.         <keycombo>
  411.               <keycap>Ctrl</keycap>
  412.           <keycap>W</keycap>
  413.         </keycombo>.
  414.       </para> 
  415.     </listitem> 
  416.       </itemizedlist> 
  417.       <tip>
  418.       <para>This is a tip.</para>
  419.       </tip>
  420.     </sect2> 
  421.     <!-- ================ Usage Subsection ================================ -->
  422.     <sect2 id="myapp-scroll-image"> 
  423.       <title>Scrolling an Image</title> 
  424.       <para>To scroll around an image that is larger than the image window or
  425.     full screen window, you can use the following methods:</para> 
  426.       <itemizedlist> 
  427.     <listitem> 
  428.       <para>Use the arrow keys on the keyboard.</para> 
  429.     </listitem> 
  430.     <listitem> 
  431.       <para>Drag the image in the opposite direction to the direction in
  432.         which you want to scroll. For example, if you want to
  433.           scroll down the image, 
  434.         drag the image upwards in the window.</para> 
  435.     </listitem> 
  436.     <listitem> 
  437.       <para>Use the scrollbars on the window.</para> 
  438.     </listitem> 
  439.       </itemizedlist> 
  440.     </sect2>
  441.     <!-- ================ Usage Subsection ================================ -->
  442.     <sect2 id="myapp-close-image"> 
  443.       <title>Closing an Image</title> 
  444.       <para>To close an image, choose 
  445.     <menuchoice> 
  446.       <guimenu>File</guimenu> 
  447.       <guimenuitem>Close This Window</guimenuitem> 
  448.     </menuchoice>. If the window is the last
  449.     &app; window open, the application exits. </para> 
  450.       <para>To quit &app; and close all of the
  451.     windows that you opened in the current session, choose 
  452.     <menuchoice> 
  453.       <guimenu>File</guimenu> 
  454.       <guimenuitem>Exit</guimenuitem> 
  455.     </menuchoice>. </para> 
  456.       <warning>
  457.       <para>This is a warning.</para>
  458.       </warning>
  459.     </sect2> 
  460.   </sect1>
  461.   <!-- ============= Customization ============================= -->
  462.   <!-- Use this section to describe how to customize the application. -->
  463.   <sect1 id="myapp-prefs"> 
  464.     <title>Preferences</title> 
  465.     <para>To configure &app;, choose 
  466.       <menuchoice> 
  467.     <guimenu>Edit</guimenu> 
  468.     <guimenuitem>Preferences</guimenuitem> 
  469.       </menuchoice>. The 
  470.       <guilabel>Preferences</guilabel> dialog contains the following tabbed
  471.       sections:</para> 
  472.     <itemizedlist> 
  473.       <listitem> 
  474.     <para> 
  475.       <xref linkend="myapp-prefs-display"/></para> 
  476.       </listitem> 
  477.       <listitem> 
  478.     <para> 
  479.       <xref linkend="myapp-prefs-viewers"/></para> 
  480.       </listitem> 
  481.     </itemizedlist>
  482. <!-- =============== Customization Subsection ================ -->
  483. <!-- Use a new section to describe different tabbed sections on the Preferences
  484.          dialog. -->
  485.     <sect2 id="myapp-prefs-display"> 
  486.       <title>Display</title> 
  487.       <variablelist> 
  488.     <varlistentry> 
  489.       <term> 
  490.         <guilabel>Interpolation type</guilabel> </term> 
  491.       <listitem> 
  492.         <para>Use this drop-down list box to specify the
  493.           interpolation method that
  494.           &app; uses when the
  495.           application resizes images. Select one of the following
  496.           options:</para>
  497.         <itemizedlist> 
  498.           <listitem> 
  499.         <para> 
  500.           <guilabel>Nearest neighbor</guilabel> </para> 
  501.         <para>This method of interpolation takes a location in the
  502.           original image and replicates the pixel that is
  503.           nearest to this location. When 
  504.           you zoom in on an image, the pixels are
  505.           replicated. When you zoom out of an 
  506.           image, the image loses some of its detail. </para> 
  507.           </listitem> 
  508.           <listitem> 
  509.         <para> 
  510.           <guilabel>Bilinear</guilabel> </para> 
  511.         <para>This is a simple and fast method of interpolation. When
  512.           you zoom in on an image, &app; uses up to four
  513.           adjacent pixels to compute the colors of the new
  514.           pixels. When you zoom out of 
  515.           an image, &app; averages regions of color in the
  516.           existing image to compute the colors of the pixels. </para> 
  517.           </listitem> 
  518.           <listitem> 
  519.         <para> 
  520.           <guilabel>Hyperbolic</guilabel> </para> 
  521.         <para>This is a high-quality, slow method of interpolation. The
  522.           application performs interpolation on the image in
  523.           the manner described in 
  524.           Digital Image Warping by George Wolberg.</para> 
  525.           </listitem> 
  526.         </itemizedlist> 
  527.         <para>Default: 
  528.           <guilabel>Nearest neighbor</guilabel>.</para> 
  529.       </listitem> 
  530.     </varlistentry> 
  531.     <varlistentry> 
  532.       <term> 
  533.         <guilabel>Transparency type</guilabel> </term> 
  534.       <listitem> 
  535.         <para>Use this drop-down list box to specify how
  536.           &app; displays transparent or partially opaque
  537.           backgrounds in images. Select one of the following options:</para> 
  538.         <itemizedlist> 
  539.           <listitem> 
  540.         <para> 
  541.           <guilabel>Dark checks</guilabel> </para> 
  542.         <para>This option displays black and dark gray checks.</para> 
  543.           </listitem> 
  544.           <listitem> 
  545.         <para> 
  546.           <guilabel>Midtone checks</guilabel> </para> 
  547.         <para>This option displays dark gray and light gray
  548.           checks.</para> 
  549.           </listitem> 
  550.           <listitem> 
  551.         <para> 
  552.           <guilabel>Light checks</guilabel> </para> 
  553.         <para>This option displays light gray and white checks.</para> 
  554.           </listitem> 
  555.           <listitem> 
  556.         <para> 
  557.           <guilabel>Black only</guilabel> </para> 
  558.         <para>This option displays solid black.</para> 
  559.           </listitem> 
  560.           <listitem> 
  561.         <para> 
  562.           <guilabel>Gray only</guilabel> </para> 
  563.         <para>This option displays solid gray.</para> 
  564.           </listitem> 
  565.           <listitem> 
  566.         <para> 
  567.           <guilabel>White only</guilabel> </para> 
  568.         <para>This option displays solid white.</para> 
  569.           </listitem> 
  570.         </itemizedlist> 
  571.         <para>Default: 
  572.           <guilabel>Dark checks</guilabel>.</para> 
  573.       </listitem> 
  574.     </varlistentry> 
  575.     <varlistentry> 
  576.       <term> 
  577.         <guilabel>Check size</guilabel> </term> 
  578.       <listitem> 
  579.         <para>Use this drop-down list box to specify the size of the checks
  580.           to use to display transparent or partially opaque
  581.           backgrounds in images. This 
  582.           option is only relevant if you choose 
  583.           <guilabel>Dark checks</guilabel>, 
  584.           <guilabel>Midtone checks</guilabel>, or 
  585.           <guilabel>Light checks</guilabel> from the 
  586.           <guilabel>Transparency type</guilabel> drop-down list box.
  587.           Select one of the following options:</para> 
  588.         <itemizedlist> 
  589.           <listitem> 
  590.         <para> 
  591.           <guilabel>Small</guilabel></para> 
  592.           </listitem> 
  593.           <listitem> 
  594.         <para> 
  595.           <guilabel>Medium</guilabel></para> 
  596.           </listitem> 
  597.           <listitem> 
  598.         <para> 
  599.           <guilabel>Large</guilabel></para> 
  600.           </listitem> 
  601.         </itemizedlist> 
  602.         <para>Default: 
  603.           <guilabel>Small</guilabel>.</para> 
  604.       </listitem> 
  605.     </varlistentry> 
  606.     <varlistentry> 
  607.       <term> 
  608.         <guilabel>Dither type</guilabel> </term> 
  609.       <listitem> 
  610.         <para>Use this drop-down list box to specify the dithering method
  611.           to use to display images. Dithering is a technique that
  612.           is used to simulate 
  613.           colors in the original image file but that your system
  614.           can not display. Select 
  615.           one of the following options:</para> 
  616.         <itemizedlist> 
  617.           <listitem> 
  618.         <para> 
  619.           <guilabel>None</guilabel> </para> 
  620.         <para>This option does not use dithering. </para> 
  621.           </listitem> 
  622.           <listitem> 
  623.         <para> 
  624.           <guilabel>Normal (pseudocolor)</guilabel> </para> 
  625.         <para>This option performs dithering on pseudocolor displays,
  626.           which use a limited palette of colors. </para> 
  627.           </listitem> 
  628.           <listitem> 
  629.         <para> 
  630.           <guilabel>Maximum (high color)</guilabel> </para> 
  631.         <para>This option performs dithering on pseudocolor and high
  632.           color displays. </para> 
  633.           </listitem> 
  634.         </itemizedlist> 
  635.         <para>Default: 
  636.           <guilabel>None</guilabel>.</para> 
  637.       </listitem> 
  638.     </varlistentry> 
  639.     <varlistentry> 
  640.       <term> 
  641.         <guilabel>Two-pass scrolling</guilabel> </term> 
  642.       <listitem> 
  643.         <para>Select this option to render an image in two passes
  644.           when you scroll the image quickly. The first pass
  645.           renders a low quality version of the image. The second
  646.           pass renders a full quality version of the image over
  647.           the low quality version. Two-pass scrolling enables you
  648.           to view at least a low quality version of the image at
  649.           all times regardless of how quickly you scroll the
  650.           image. 
  651.         </para>
  652.         <para>Default: unselected.</para> 
  653.       </listitem> 
  654.     </varlistentry> 
  655.       </variablelist> 
  656.     </sect2>
  657.     <!-- ============= Customization Subsection ===================== -->
  658.     <!-- Another tabbed section on the Preferences dialog. -->
  659.     <sect2 id="myapp-prefs-viewers"> 
  660.       <title>Viewers</title> 
  661.       <para>You can set the following viewer preferences: 
  662.     <itemizedlist> 
  663.       <listitem> 
  664.         <para> 
  665.           <xref linkend="myapp-viewer-prefs-image-window"/></para> 
  666.       </listitem> 
  667.       <listitem> 
  668.         <para> 
  669.           <xref linkend="myapp-viewer-prefs-full-screen"/></para> 
  670.       </listitem> 
  671.     </itemizedlist> </para> 
  672.       <sect3 id="myapp-viewer-prefs-image-window"> 
  673.     <title>Image Windows</title> 
  674.     <para>The 
  675.       <guilabel>Image Windows</guilabel> group contains the preferences
  676.       that you can set to view images in image windows.</para> 
  677.     <variablelist> 
  678.       <varlistentry> 
  679.         <term> 
  680.           <guilabel>Use scrollbars</guilabel> </term> 
  681.         <listitem> 
  682.           <para>Use this drop-down list box to specify when to use
  683.         scrollbars to scroll through an image. Select one of
  684.         the following options:</para> 
  685.           <itemizedlist> 
  686.         <listitem> 
  687.           <para> 
  688.             <guilabel>Never</guilabel> </para> 
  689.           <para>This option never displays scrollbars. You can use the
  690.             arrow keys on the keyboard or the mouse to scroll
  691.             through the image. </para>  
  692.         </listitem> 
  693.         <listitem> 
  694.           <para> 
  695.             <guilabel>Only if image does not fit</guilabel> </para> 
  696.           <para>This option displays scrollbars when the image is
  697.             larger than the image window.</para> 
  698.         </listitem> 
  699.           </itemizedlist> 
  700.           <para>Default: 
  701.         <guilabel>Never</guilabel>.</para> 
  702.         </listitem> 
  703.       </varlistentry> 
  704.       <varlistentry> 
  705.         <term> 
  706.           <guilabel>Pick window size and zoom factor
  707.         automatically</guilabel> </term> 
  708.         <listitem> 
  709.           <para>Select this option to resize the image window to fit the
  710.         image or to resize the image to fit the image
  711.         window. If the image is small, 
  712.         &app; resizes the image window to fit the image. If
  713.         the image is large, &app; resizes the image to fit
  714.         the image window. </para> 
  715.           <para>Default: unselected.</para> 
  716.         </listitem> 
  717.       </varlistentry> 
  718.       <varlistentry> 
  719.         <term> 
  720.           <guilabel>Open images in a new window</guilabel> </term> 
  721.         <listitem> 
  722.           <para>Select this option to open a new
  723.         &app; window each time you open an image. If you do
  724.         not select this option, &app; replaces the existing
  725.         image with the new image when you open an image. </para> 
  726.           <para>Default: unselected.</para> 
  727.         </listitem> 
  728.       </varlistentry> 
  729.     </variablelist> 
  730.       </sect3> 
  731.       <sect3 id="myapp-viewer-prefs-full-screen"> 
  732.     <title>Full Screen</title> 
  733.     <para>The 
  734.       <guilabel>Full Screen</guilabel> group contains the preferences that
  735.       you can set to view images in full screen mode.</para> 
  736.     <variablelist> 
  737.       <varlistentry> 
  738.         <term> 
  739.           <guilabel>Use scrollbars</guilabel> </term> 
  740.         <listitem> 
  741.           <para>Use this drop-down list box to specify when to use
  742.         scrollbars to scroll through an image. Select one of the following
  743.         options:</para> 
  744.           <itemizedlist> 
  745.         <listitem> 
  746.           <para> 
  747.             <guilabel>Never</guilabel> </para> 
  748.           <para>This option never displays scrollbars. You can use the
  749.             arrow keys on the keyboard or the mouse to scroll
  750.             through the image. </para>  
  751.         </listitem> 
  752.         <listitem> 
  753.           <para> 
  754.             <guilabel>Only if image does not fit</guilabel> </para> 
  755.           <para>This option displays scrollbars when the image is
  756.             larger than the full screen. </para> 
  757.         </listitem> 
  758.           </itemizedlist> 
  759.           <para>Default: 
  760.         <guilabel>Never</guilabel>.</para> 
  761.         </listitem> 
  762.       </varlistentry> 
  763.       <varlistentry> 
  764.         <term> 
  765.           <guilabel>Use 1:1 zoom factor</guilabel> </term> 
  766.         <listitem> 
  767.           <para>Select this option to use the 1:1 zoom factor when you open
  768.         an image. The 1:1 zoom factor displays the image at
  769.         its actual size. </para>  
  770.           <para>Default: selected.</para> 
  771.         </listitem> 
  772.       </varlistentry> 
  773.       <varlistentry> 
  774.         <term> 
  775.           <guilabel>Use same zoom factor as image window</guilabel> </term>
  776.         
  777.         <listitem> 
  778.           <para>Select this option to use the same zoom factor that the
  779.         application uses to display the image in an image
  780.           window. </para>  
  781.           <para>Default: unselected.</para> 
  782.         </listitem> 
  783.       </varlistentry> 
  784.       <varlistentry> 
  785.         <term> 
  786.           <guilabel>Fit all images to screen</guilabel> </term> 
  787.         <listitem> 
  788.           <para>Select this option to resize images to fill the full screen
  789.         when you open the images in full screen mode. </para> 
  790.           <para>Default: unselected.</para> 
  791.         </listitem> 
  792.       </varlistentry> 
  793.       <varlistentry> 
  794.         <term> 
  795.           <guilabel>Fit standard-sized images to screen</guilabel> </term> 
  796.         <listitem> 
  797.           <para>Select this option to automatically resize images
  798.         that are the same size as standard screens so that the
  799.         images fill the full screen when you open them in full
  800.         screen mode. If you select this option, &app; ignores
  801.         the settings for the previous three options when you
  802.         open an image that is the same size as a standard
  803.         screen.  Examples of standard screen sizes are 640 x
  804.         480 pixels, 1024 x 768 pixels, and so on. </para>
  805.           <para>Default: unselected.</para> 
  806.         </listitem> 
  807.       </varlistentry> 
  808.       <varlistentry> 
  809.         <term> 
  810.           <guilabel>Put a bevel around the edge of the screen</guilabel>
  811.         </term> 
  812.         <listitem> 
  813.           <para>Select this option to display a 3D beveled border around
  814.         the full screen view of an image. </para> 
  815.           <para>Default: unselected.</para> 
  816.         </listitem> 
  817.       </varlistentry> 
  818.     </variablelist> 
  819.       </sect3> 
  820.     </sect2> 
  821.   </sect1>
  822. <!-- ============= Bugs ================================== -->
  823. <!-- This section is optional and is commented out by default. 
  824.      You can use it to describe known bugs and limitations of the 
  825.       program if there are any - please be frank and list all
  826.      problems you know of. 
  827.   
  828.   <sect1 id="mayapp-bugs">
  829.   <title>Known Bugs and Limitations</title>
  830.   <para> </para>
  831.  </sect1>
  832. -->
  833. <!-- ============= About ================================== -->
  834. <!-- This section contains info about the program (not docs), such as
  835.       author's name(s), web page, license, feedback address. This
  836.       section is optional: primary place for this info is "About.." box of
  837.       the program. However, if you do wish to include this info in the
  838.       manual, this is the place to put it. Alternatively, you can put this information in the title page.-->
  839.   <sect1 id="myapp-about"> 
  840.     <title>About &app;</title> 
  841.     <para> &app; was written by GNOME-HACKER
  842.       (<email>hacker@gnome.org</email>). To find more information about
  843.       &app;, please visit the 
  844.       <ulink url="http://www.my-gnome-app.org" type="http">MY-GNOME-APP Web
  845.     page</ulink>. </para>
  846.     <para>
  847.       To report a bug or make a suggestion regarding this application or
  848.       this manual, follow the directions in the
  849.       <ulink url="ghelp:user-guide?feedback-bugs" type="help">Feedback section of the GNOME User Guide</ulink>.
  850.     </para>
  851.  
  852.     <para> This program is distributed under the terms of the GNU
  853.       General Public license as published by the Free Software
  854.       Foundation; either version 2 of the License, or (at your option)
  855.       any later version. A 
  856.       <ulink url="ghelp:gpl" type="help">copy of this license</ulink>
  857.       is included with this documentation; another can be found in the file
  858.       COPYING included with the source code of this program. </para>
  859.  
  860.   </sect1> 
  861. </article>
  862.